home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 December / Software of the Month Club 1996 December.iso / pc / dos / sri / dtp / capture / capture.doc < prev    next >
Encoding:
Text File  |  1995-10-31  |  11.7 KB  |  281 lines
  1. CAPTURE IT!   - Screen capture utility                  Version 2.2  26/Nov/94
  2. SCREEN LOADER - Slideshow utility
  3. Copyright(c) 1991,1992,1993,1994 by Henrique Avila Vianna. All rights reserved
  4. ------------------------------------------------------------------------------
  5.  
  6.                     D O C U M E N T A T I O N   F I L E
  7.  
  8. │    New features and changes in this revision are indicated by a vertical
  9. │ bar at the left margin.
  10.  
  11. Introduction
  12. ------------
  13.  
  14.      Can't you get that great picture of your favorite game? If your screen
  15. grabber is not as powerful as you need, don't worry... Capture It! has arrived
  16. to save you!
  17.  
  18.      The ordinary screen capture utilities use the keyboard interrupt to copy
  19. the screen when you press a hotkey. The problem is that the latest games
  20. intercept INT 09 (the keyboard interrupt), what prevents the grabber from
  21. receiving keyboard commands.
  22.  
  23.      Capture It! has an exclusive timer system that captures the video memory
  24. contents automatically every "n" seconds! You are still able to get the screen
  25. manually, using the hotkey CTRL+ALT+C.
  26.  
  27.      The program currently captures graphic screens of the following modes:
  28.  
  29.          Hercules     720x348 monochrome
  30.          CGA          320x200 4 colors
  31.          CGA          640x200 2 colors
  32.          EGA/VGA      320x200 16 colors
  33.          EGA/VGA      640x350 16 colors
  34.          VGA          640x480 16 colors
  35.          VGA/MCGA     320x200 256 colors
  36.  
  37.  
  38. How does it work?
  39. -----------------
  40.  
  41.      Capture It! is a TSR (Terminate-and-Stay-Resident) program. Once installed
  42. it runs in background waiting for a request to get the screen (when you press
  43. the hotkey or the specified time interval has been reached).
  44.  
  45.      While resident, Capture It! uses about 10K bytes of memory and it CAN be
  46. loaded high, if you have an expanded memory manager and you need as much base
  47. memory as possible.
  48.  
  49.      The syntax is:
  50.  
  51.          CAPTURE <path> [<time> <number_of_screens>]
  52.  
  53.          <path> - The path where the captured screens are to be saved.
  54.                   This item is required.
  55.  
  56.          <time> - Time in seconds between each screen captured.
  57.                   This item is optional. If not specified, the program will
  58.                   capture the screen only when you press CTRL+ALT+C.
  59.  
  60.          <number_of_screens> - Maximum number of screens that should be captured
  61.                   by the program. Useful to avoid filling up your disk with
  62.                   dozens of screens! If you use the <time> parameter, you must
  63.                   specify the <number_of_screens>.
  64. │                 The maximum <number_of_screens> is 9999.
  65.  
  66.      Examples:
  67.  
  68.          capture E:
  69.               captures the screen when the hotkey is pressed and save
  70.               the files in the current directory of drive E:
  71.  
  72.          capture D:\GRAPHICS\PICTURES\ 10 20
  73.               captures the video contents every 10 seconds, or when the
  74.               hotkey is pressed. A maximum of 20 screens will be captured,
  75.               and the files will be saved in d:\graphics\pictures\
  76.               (DON'T FORGET THE LAST BACKSLASH!)
  77.  
  78. │        capture /R
  79. │             removes a previous installed copy of the program from the
  80. │             memory.
  81.  
  82.          capture  OR  capture /?
  83.               will show you a brief help text.
  84.  
  85.  
  86.      The program will only capture the screen if the video mode at the moment
  87. of the capture request is one of the valid modes (listed above). Otherwise, the
  88. request will be noted down and, as soon as the video mode is set properly, it
  89. will be attended. When the screen is captured and saved successfully, the PC
  90. speaker beeps twice.
  91.  
  92. │    The captured screens are saved in files named PICTnnnn.CAP (where nnnn is
  93. │ a number from 0001 to 9999).
  94. │
  95. │    After capturing all the screens you want, press CTRL+ALT+R at the DOS
  96. │ prompt to uninstall Capture It! from memory. You may also run capture /r to
  97. │ remove it.
  98. │
  99. │    If you want to change the time between captured screens or the maximum
  100. │ number of screens, simply run the program again using the same syntax showed
  101. │ above and the parameters will be updated without installing a new copy of
  102. │ the program in the memory. If you run the program again without the <time>
  103. │ and <number_of_screens> parameters, the timer option will be disabled. Note
  104. │ that if you have already captured, say, 5 screens and you want to get 3 more
  105. │ screens you should specify a new <number_of_screens> of 8, not 3.
  106. │
  107. │    The directory where the screens are saved can't be changed while the
  108. │ program is resident. You must remove it and install a new copy with the new
  109. │ desired path.
  110. │
  111. │    ATTENTION! When you install a new copy of Capture It!, it starts saving
  112. │ the screens as PICT0001.CAP. So, you must rename previous captured files to
  113. │ prevent the program from rewriting them.
  114.  
  115.  
  116. Now what?
  117. ---------
  118.  
  119.      The Capture It! files are saved in an uncompressed form, to speed up the
  120. capturing process, but these .CAP files are not a standard format. Well, at
  121. least the CGA captured screens can be BLOADed via BASIC. :) :)
  122.  
  123.      But..... thanks to Oliver Fromme you can now convert these .CAP files to
  124. the great (and well-known) GIF format.
  125.      There are two ways to do it:
  126.          - using directly the command-line driven CAP2GIF program (please
  127. refer to the CAP2GIF.DOC file for instructions);
  128.          - or using SCReen LoaDer that lets you view and choose the pictures
  129. you want to convert to GIF (if you are capturing by time you'll propably get
  130. some undesired screens, so SCRLD lets you also delete files).
  131.  
  132.      The SCRLD syntax is:
  133.  
  134.          SCRLD [<path>] [/T<time>] [/F] [/L]
  135.  
  136.          <path> - Path where to search for the .CAP files.
  137.                   If not specified assumes the current path.
  138.  
  139.          <time> - Time in seconds between each picture shown.
  140.                   If not specified waits for a keypress to change picture.
  141.                   The maximum <time> value is 65.
  142.  
  143.          /F     - If specified, uses fade effects between screens (VGA only).
  144.  
  145.          /L     - If specified, stays on loop.
  146.  
  147.      While viewing a picture, the following command keys are available:
  148.          [G]    - Calls the CAP2GIF program to save the picture as a .GIF file.
  149.          [D]    - Deletes the file.
  150.          [ESC]  - Quits to DOS.
  151.      Using the /T<time> option disables the [G] and [D] keyboard commands.
  152.  
  153.      PLEASE NOTE THAT CAP2GIF AND SCRLD PROGRAMS *MUST* BE IN THE SAME DIRECTORY
  154.  
  155.      Examples:
  156.  
  157.          scrld
  158.               displays all .CAP files in the current drive and directory
  159.  
  160.          scrld F:\
  161.               displays all .CAP files in the root of drive F:
  162.  
  163.          scrld D:\GRAPHICS\TEMP\ /T5 /F /L
  164.               displays all .CAP files in d:\graphics\temp\ with an interval
  165.               of 5 seconds between each one. Uses fade in and fade out effects,
  166.               and stays in loop until the ESC key is pressed.
  167.  
  168.          scrld /?
  169.               shows a brief help text.
  170.  
  171.      SCRLD can also read standard BASIC BSAVED screens (CGA only).
  172.  
  173.  
  174. Known problems
  175. --------------
  176.  
  177.      As you know, MS-DOS isn't a multi-task environment. TSR applications run
  178. in background, using hardware interrupts to have the processor's attention.
  179. These applications are somewhat "intruders" in the system, and may not run
  180. properly all the time.
  181.  
  182.      After capturing a screen, Capture It! may cause the system to hang up, or
  183. may confuse the screen display. In both cases, the first screen captured must
  184. be ok, so you may need to quit the game and run it again to get more screens.
  185. (Using a RAM drive to store the captured screens may be not a good idea if you
  186. have to reset the system! :-) ).
  187.  
  188.      If you are capturing manually, try not to use the hotkey during long disk
  189. transfers, specially if you are running from floppies.
  190.  
  191.      Remove unnecessary TSR programs while using Capture It!. Two or more TSR
  192. applications may be incompatible with each other.
  193.  
  194.      Some programs may access the video board in a non-standard way in some
  195. video modes. Newer games access the VGA 256-color mode differently from the
  196. MCGA, what causes most of screen capture utilities to read the video information
  197. incorrectly. Version 2.1 of Capture It! corrects this problem. Anyway, if you
  198. get a distorted image of the captured screen, try using another video
  199. configuration in your program.
  200.  
  201.      A friend reported me problems using the Write Cache of SMARTDRV (the
  202. screens didn't get saved). I personally use only the Read Cache and it
  203. works fine.
  204.  
  205.      Attention EGA card owners:
  206.      Screens captured on EGA cards won't be correctly displayed by SCRLD on a
  207. VGA card. Convert them to GIF to assure compatibility.
  208.      Screens captured on EGA cards with Capture It! versions earlier than 2.1a
  209. won't be properly converted to GIF by CAP2GIF.
  210.  
  211.  
  212. Disclaimer
  213. ----------
  214.  
  215. *******************************************************************************
  216. **  All warranties are disclaimed, including damage to hardware and/or       **
  217. **  software from use of this product. The author will not be liable to you  **
  218. **  for any incidental or consequential damages arising out of your use or   **
  219. **  inability to use the program, or any other claim by any other party.     **
  220. *******************************************************************************
  221.  
  222.  
  223. Distribution Policy
  224. -------------------
  225.  
  226.      Capture It! and SCReen LoaDer are been distributed as FREEWARE programs.
  227.  
  228.      That means they can be freely copied, since the files CAPTURE.EXE,
  229. SCRLD.EXE, CAPTURE.DOC, CAP2GIF.EXE and CAP2GIF.DOC are distributed together,
  230. unmodified, in the uncompressed form or compressed together by any popular
  231. file compressor (such as PKZIP, ARJ, etc.) in a file named CAPTUR22.???.
  232.  
  233. Capture It! and SCReen LoaDer history
  234. -------------------------------------
  235.  
  236.      Version 1.0 - 06/Mar/91
  237.                    Only CGA modes supported. Uses the [Gray *] key to capture
  238.                    screens from programs that intercept the PrtScr interrupt.
  239.  
  240.      Version 2.0 - 02/Jan/92
  241.                    Timer system introduced.
  242.                    Correct CGA palette saved.
  243.                    New Hercules, EGA and VGA/MCGA 320x200 modes supported.
  244.  
  245.      Version 2.1 - 17/Jul/93
  246.                    Fixed bug in VGA (non-MCGA) 256 colors screens.
  247.                    New hi-res EGA and VGA modes supported.
  248.                    Fade effects extended to all VGA modes (SCReen LoaDer).
  249.                    First version distributed on Internet.
  250.  
  251.      Version 2.1a- 20/Aug/93
  252.                    CAP2GIF program by Oliver Fromme included in the package.
  253.                    Minor bugs fixed.
  254.                    SCReen LoaDer now calls CAP2GIF and deletes files.
  255.                    Version number excluded from the executable files names.
  256.  
  257. │    Version 2.2 - 26/Nov/94
  258. │                  Command line option added to remove resident program.
  259. │                  Now updates resident parameters (no need to uninstall).
  260. │                  Maximum number of screens raised to 9999 (useful to anybody?)
  261. │                  Fade effect improved on SCReen LoaDer.
  262. │                  Minor optimizations and bug-fixes made.
  263.  
  264. Contacting the author
  265. ---------------------
  266.  
  267.      I WANNA HEAR FROM YOU!
  268.  
  269.      If you find Capture It! of use, if you like it or dislike it, please let
  270. me know! Your comments, bug reports, suggestions, GOOD GIF PICTURES or any kind
  271. of contribution are welcome.
  272.  
  273.      Send them to:
  274.  
  275.      HENRIQUE AVILA VIANNA         │    E-Mail addresses:
  276.      RUA ARMANDO SICA 55           │
  277.      96020-140  PELOTAS, RS        │    InterNet: HVIANNA@VORTEX.UFRGS.BR
  278.      BRASIL                        │    BITNet  : HVIANNA@BRUFPEL.BITNET
  279.  
  280.  
  281. ---------------------------------> End of File <--------------------------------